Explanation

This PR adds a doNotUpdateState option to ExecuteRequestOptions that enables external consumers to use RampsController methods without modifying the controller's state.

• Added doNotUpdateState?: boolean to ExecuteRequestOptions in RequestCache.ts
• Updated getCountries(), getTokens(), getProviders(), and getPaymentMethods() to conditionally skip state updates when doNotUpdateState: true
• The option is passed through method signatures including setUserRegion() and all trigger methods
• Request caching and deduplication still work normally - only the domain state updates are skipped

Use Case

External teams consuming the RampsController may need to call API methods (e.g., getTokens, getProviders) to fetch data for display or comparison purposes without polluting the controller's persisted state. For example:

// Fetch tokens for a different region without affecting the user's current state
const otherRegionTokens = await rampsController.getTokens('fr', 'buy', {
  doNotUpdateState: true,
});

References

https://consensyssoftware.atlassian.net/browse/TRAM-3231

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them